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VI EDITOR QUICK REFERENCE 


INTRODUCTION 


This quick reference is based on UNIX* System V 
Release 2.0. To use the full screen editing capabilities of 
the visual (vi) editor your terminal must be defined by 
the system. You must then tell the system about your 
terminal as shown in Specifying Terminal Type. If 
your terminal is not defined by the system, you can use 
the vi editor in the open mode. Most vi commands will 
work in the open mode, but full screen editing is not 
provided. 


Specifying Terminal Type 


TERM=type Type defined in system terminfo file. 
export TERM Allows visual editor to be used in any 


subshell. 
Notation 
Denotes the CONTROL key to be held down 
while the following character is typed. 
t Used to show the caret ( ) should be typed. 
[n] Optional number of repititions preceding a 


command. Do not type [ ]. In most cases 
omitting n defaults to one. 


* Trademark of AT&T Bell Laboratories 
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object 


The text object—(character, word, sentence, 
paragraph, or line) that a command 
operates on. 


Special Keys 


<ESC> 


<CR> 
BS 


DELETE 


A prefix to a set of commands for file and 
option manipulation and escapes to the shell. 
The : and later keystrokes appear at the 
bottom of the screen. The command is 
terminated with a <CR> or <ESC>. 
ESCAPE key used to return to command 
mode. Type <ESC> when you are not sure 
of the current mode. Causes a beep if 
already in command mode (harmless). 
Carriage RETURN key. 

BACKSPACE key. “H on terminals without 
a backspace key. 

Sometimes labelled DEL, BREAK, or 
RUBOUT. This key generates an interrupt 
that tells the editor to stop what it is doing. 
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ENTERING VI EDITOR 


Note: Follow entry with <CR> 


vi file 

vi 

vi+ n file 

vi + file 

vi-r 

vi -r file 

vi filel, 
file? ... 

vi -t tag 


vi | /pat file 
view file 


:q<CR> 
iqi<CR> 


:wq<CR> 
ZZ 


Edit at first line of file 

Edit a new empty file 

Edit at n line in file 

Edit at last line in file 

List saved files 

Recover file and edit saved file 


Edit filet; file? ... (After filel enter :n for 
each remaining [ile.) 

Edit at tag file in lags file 

Search for and edit at pattern in file 

Read only view of file 


LEAVING VI EDITOR 


Quit vi when no changes have occurred 
since last write 

Quit vi, do not save changes since last 
write 

Write and quit (exit vi, saving changes) 
Write and quit (exit vi, saving changes) 
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POSITIONING THE CURSOR 


File Positioning 


[nf F Forward /n/ full screens 

[nn] B Backward screens 

[n] D Scroll down (default is half sereen) 
[n] U Scroll up (default is half sereen) 
[n] E Scroll down 1 line 

[n] Y¥ Scroll up 1 line 

[nJG xyoLo line n (default is last line of file) 
[nj/pat Next line matching pat 

[nP?pat Previous line matching pat 

[njn Repeat last / or ? 

[n[N Reverse last / or ? 


[nj/pat/+m mth line after pat 
[nPpat?-m mth line before pat 


Screen Positioning 


[nf To nth line from top of display. Without 
nto top 
[nf To nth line from bottom of display. 
Without n to bottom 
M To middle line of display 
ae 


Line Positioning 


0 Beginning of line 

[n]$ End of line 

[n]+ Next line, at first non-white 
[n]- Previous line, at first non-white 
[n]<CR> Return, same as + 

[nj\\ or j Next line, same column 

[n]* or k Previous line, same column 


Character Positioning Within a Line 


[n/t First non white 
[nfh or > Forward one character 
[nfl or — Backward one character 


[nj/spacebar Same as 
[nJoackspace Backwards one character 


[Inf Same as <«- or backspace 

[n]fx Find x forward 

[n]F x Find x backward 

[n]tx Move up to x forward 

[n]Tx Move up to x backward 

[nj Repeat last f, F, t, or T 

[n], Inverse of ; 

[nh Move to specified column number /n] 
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Word Positioning 


[n]w 


[n]b 


[nJe 


[n]W 
[n]JB 
[nJE 


Move forward to beginning of word. 
Punctuation and strings. of punctuation 
count as words. 

Move back to beginning of word. 
Punctuation and strings of punctuation 
count as words. 

Move forward to end of word. 
Punctuation and strings of punctuation 
count as words. 

Move forward to beginning of word. 
Punctuation ignored. 

Move back to beginning of word. 
Punctuation ignored, 

Move forward to end = of word. 
Punctuation ignored. 


Sentence, Paragraph, Heading Positioning 


[n]) 
[n]( 
[n]} 
[n]{ 
[nf}] 
[nfl 


Forward to next sentence 
Back a sentence 

Forward to next paragraph 
Back a paragraph 

Forward to next heading 
Back a heading 


atext<ESC> 
itext<ESC> 
Atext<ESC> 
Itext<ESC> 
otext<ESC> 
Otext<ESC> 


CREATING TEXT 


Append after cursor, until <ESC> 
Insert before cursor 

Append at end of line 

Insert before first non-blank 
Open line below 

Open above 


MAKING CORRECTIONS DURING TEXT 


CREATION 


Erase last word during an insert 

Kill the insert on this line (usually @, X, 
or U) 

Erase last character 

Erase last character 

Escapes H, your erase and kill 

Ends insertion, back to command mode 
Interrupt, terminates insert 

Racktab over autoindent 

Kill autoindent, save for next 

.. but at margin next also 

Quote non-printing character 
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Changing Text 
[n]Ctext<ESC> 


[n]Rtext<ESC> 
[n]Stext<ESC> 


MODIFYING TEXT 


Switch character from lowercase to 
uppercase and vise versa 

Change from cursor to end of line 
(same as c$) 

Replace characters 

Substitute on lines 


[n]eobjtext<ESC> Change the specified object (word) to 


[n]rx 
[n]stext<ESC> 
[nJectext<ESC> 


Deleting Text 


the following text 

Replace character with x 

Replace a character with a text string 
Change a whole line 


D . Delete from cursor to end of line 
[n]x Delete a character 
[n]X Delete character to left of cursor 


[n]d(object) Delete the specified object (word, sentence, 
paragraph, etc.) 
[njdd Delete a line 


Moving Text 


iy Named register r that save delete 
commands. Legal values of r are letters a 
through z. 

"rp Puts deleted text from registers "r after 
or below cursor 

"rTP Puts deleted text from registers "r before 
or above cursor 

p Puts last deleted text after or below 
cursor 

P Puts last deleted text before or above 
cursor 


Copying Text 


"r Named register r that can precede a yank 
command. Legal values of r are letters a 
through z. 

y/nJobject Yanks a copy of the following object into a 
register 

[n]¥ Yanks a copy of the current. line into a 
register 

[n]yy Same as Y 

"rp Puts yanked text from register " r after or 
below cursor 

Gao Puts yanked text from register "r befor: 


or above cursor 


Puts last yanked text after or below 
cursor 
Puts last yanked text before or above 
cursor 


UNDOING, REDOING, RETRIEVING 


Undo last change 

Restore current line 

Repeat last change 

Retrieve one of last 9 deletes; 4 is a 
hidden register numbered 1 through 9. 
Retrieved in reverse order. 


DOING GLOBAL SEARCHES AND CHANGES 


Note: Fol 
sg/text 


:g/text/p 
:g/texi/nu 


:[m],[n]/g/text 


:/m/],[n]g/text/p 


low entry with <CR> 


Move cursor to last line in 
file with text 

Print all lines with text 

Print all lines and line 
numbers with text 

Move cursor to n line in file 
with text 

Print all lines with text from 
line’m to n 
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:/m],/n]/g/text/nu 


:g/text/s//newtext 


:g/text/s//newtext/p 


:2/text/s//newtext/e 


:[m],[n]g/text/s//newtext 


:[m],[n]g/text/s//newtext/p 


:[m],[n]g/text/s//newtext/e 


Print all lines and line 
numbers with text from line 
mton 

Change first appearance of 
text in each line in file to 
newtext 

Change first appearance of 
text in each line in file to 
newtext and print each 
changed line 

List one at a time each line 
with text and change as 
required to newtext using a 
y<CR> 

Change first appearance of 
text in each line in file to 
newtext 

Change first appearance of 
text in lines from m to n to 
newtext and print each 
changed line 

List one at a time each line 
with text from m to n and 
change as required to newtext 
using a y<CR> 
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MANIPULATING FILES 
Copy From Another File 


wr filecCR> Copy file into buffer after current line 
:/njr file<CR> Copy file to buffer after nth line 


Copy To Another File 


Note: Follow entry with <CR> 


tw file Write the current file to file 

rw! file Overwrite existing file with file 
:w>>file Add current file to end of file 
:/m],[n]w file Write lines m through n to file 
:(m],[n]w! file Overwrite existing file with file 


containing lines m through n 
:/m],[n] w>> file Add lines m through n to end of file 


Edit Current File 


rw<CR> Write changes to current. file 

rw filec<CR> Write file to current unnamed file 

relc<OR> Reedit current. file, discarding changes 
since last write 

f£<CR> Show current file and line 

G Synonym for :f 

tta tag<CR> To tag file entry tag 

" :ta, following word is tag 


Edit Other Files From Current File 


te filecCR> 


re! file<CR> 


te | name<CR> 
te + n=CR> 
m<CR> 


m args<CR> 
te #<CR> 


a 


Edit. file when write has occurred in 
current file, return to shell after edit, 
changes not lost in current file 

Edit file when no write has occurred in 
current file, return to shell after edit, 
changes lost in current file 

Edit starting at end 

Edit starting at line n 

Edit next file in list when vi was called 
with more than one file 

Specify new list of files to be edited 

Edit alternate file when two files are 
being edited 

Synonym for :e # 


ESCAPING TO THE SHELL 


2sh<CR> 


Start a separate shell (to run several 
commands), return with D 


deommand<CR> Run one shell command , then return to 


current buffer 


ex Is 


MARKING AND RETURNING 


. Previous context 
... at first non-white in line 


mx Mark position with letter x 
La to mark x 
iS .. at first non-white in line 


MISCELLANEOUS OPERATIONS 


Repeat the last append, insert, 


delete, change, or put command 


5 Switch character from lowercase 


uppercase and vise versa 
? Delete or rubout interrupts 
i<CR><ESC> Split a line before the cursor 
a<CR><ESC> Split a line after the cursor 


L Reprint screen if ? scrambles it 
J Join lines 
mu<CR> Line number cursor is on 
xp Switch characters 
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SETTING OPTIONS 
Initializing Options 
wet x<CR> Enable option x 


:set nox<CR> Disable option x 
wet x=val<CR> Assign a value to x option 


sset<CR> Show changed options 
set all<CR> Show all options 

wet x?<CR> Show value of option x 
Options 


autoindent, ai (default: noai) 
When on, in the append, change, insert, open, or 
substitute mode a new line will be started at same 
indent as previous line. 

autoprint,ap (default: ap) 
Causes the current line to be printed after each 
delete, copy, join, move, substitute, t, undo or shift 
command. This has the same effect as supplying a 
trailing p to each such command. The autoprint is 
suppressed in globals and only applies to the last of 
many commands on a line, 

autowrite,aw (default: noaw) 
Causes the contents of the buffer to be written to 
the current file (if you have modified it) and gives a 
next, rewind, tab, or ! command, or a ‘ft (switch 


files) or "| (tag goto) command. Note: The 
command does not autowrite. In cach case, there is 
an equivalent way of switching when the autowrite 
option is set to avoid the autowrite (ex for next, 
rewind! for rewind, tag! for tag, shell for !, and 
:e #nd a :ta! command. 

beautify, bf (default: nobeautify) 
Causes all control characters except tab, newline, 
and form-feed to be discarded from the input. A 
complaint is registered the first time a backspace 
character is discarded. The beautify option does not 
apply to command input. 

directory, dir (default: dir=/tmp) 
Specifies the directory in which vi places its buffer 
file. If this directory in not writable, then the editor 
will exit abruptly when it fails to be able to create 
its buffer there. 

edcompatible (default: noedcompatible) 
Causes the presence or absence of g and ¢ suffixes 
on substitute commands to be remembered and to be 
toggled by repeating the suffices. The suffix r 
makes the substitution be as in the ~ command, 
instead of like &. 

errorbells,eb (default: nocb) 
Error messages are preceded by a bell. Bell ringing 
in open and visual mode on errors is not suppressed 
by setting noeb. Tf possible the editor always places 
the error message in a standout mode of the 
terminal (such as inverse video) instead of ringing 


the bell. 


hardtabs, ht (default: ht=8) 
Gives the boundaries on which terminal hardware 
tabs are set (or on which the system expands tabs). 

ignorecase,ic (default: noic) 
All upper case characters in the text are mapped to 
lower case in regular expression matching and vice 
versa, except in character class specifications. 

lisp (default: nolisp) 
The autoindent option indents appropriately for lisp 
code, and the (), {}, [[, and ]] commands in open and 
visual modes are modified to have meaning for lisp. 

list (default: nolist) 
All printed lines will be displayed more 
unambiguously, showing tabs and end-of-lines as in 
the list command. 

magic (default: magic for vi) 
If nomagic is set, the number of regular expression 
metacharacters is greatly reduced, with only f and $ 
having special — effects. In addition, the 
metacharacters ~ and & of the replacement pattern 
are treated as normal characters. All the normal 
metacharacters may be made magic when nomagic is 
set by preceding them with a \. 

mesg (default: mesg) 
Causes write permission to be turned off to the 
terminal while you are in visual mode if nomesg is 
set. 


apy: 


number,nu (default: nonumher) 
Causes all output lines to be printed with line 
numbers. In addition, each input line will be 
prompted for by supplying the line number it. will 
have. 

open (default: open) 
If noopen, the commands open and visual are not 
permitted. 

optimize, opt (default: optimize) 
Throughput of text is expedited by setting the 
terminal not to do automatic carriage returns when 
printing more than one (logical) line of output, 
greatly speeding output on terminals without 
addressable cursors when text with leading white 
space is printed. 

paragraphs, para (default: para—IPLPPPQPP Llbp) 
Specifies the paragraphs for the { and } operations 
in open and visual mode. The pairs of characters in 
the option’s value are the names of the macros 
which start paragraphs. 

prompt (default: prompt) 
Command mode input is prompted for with a colon 
(3): 

readonly (default:noreadonly) 
Set by chmod shell command to allow read but no 
write. 
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redraw (default: noredraw) 
The editor simulates (using great amounts of 
output) an intelligent terminal on a dumb terminal 
(e.g., during insertions in visual the characters to 
the right of the cursor position are refreshed as each 
input character is typed). This option is useful only 
at very high speed. 

remap (default: remap) 
If on, macros are repeatedly tried until they are 
unchanged. For example, if o is mapped to O, and O 
is mapped to I, then if remap is set, o will map to I; 
but if noremap is set, it will map to O. 

report (default: report=5) 
Specifies a threshold for feedback from commands. 
Any command which modifies more than the 
specified number of lines will provide feedback as to 
the scope of its changes. For commands such as 
global, open, undo, and visual, which have 
potentially more far-reaching scope, the net change 
in the number of lines in the buffer is presented at 
the end of the command subject to this same 
threshold. Thus, notification is suppressed during a 
global command on the individual commands 
performed. 

scroll (default: scroll=% window) 
Determines the number of logical lines scrolled 
when an end-of-file is received from a terminal 
input in command mode and the number of lines 
printed by a command mode z command (double the 


value of seroll). 


-19- 


sections (default: sections-SHNHH HU) 
Specifies the section macros for the [[ and ]] 
operations in open and visual modes. The pairs of 
characters in the option’s value are the names of the 
macros which start paragraphs. 

shell, sh (default: sh=/bin/sh) 
Gives the pathname of the shell forked for the shell 
escape command !, and by the shel] command. The 
default is taken from SITELL in the environment, if 
present. 

shiftwidth, sw (default: sw=8) 
Gives the width a software tabstop used in reverse 
tabbing with “D when using autoindent to append 
text, and by the shift commands. 

showmatch, sm (default: nosm) 
In open and visual mode, when a ) or } is typed, the 
cursor moves to the matching ( or { for one second if 
this matching character is on the screen. Extremely 
useful with lisp. 

slowopen, slow (terminal dependent) 
Affects the display algorithm used in visual mode, 
holding off display updating during input of new 
text to improve throughput when the terminal in use 
is both slow and unintelligent. 

tabstop, ts (default: ts—8) 
The editor expands tabs in the input file to be on 
tabstop boundaries for the purposes of display. 
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taglength, tl (default: tl=0) 
Tags are not significant beyond this many 
characters. A value of zero (the default) means that 
all characters are significant. 

tags (default: tags—tags/usr/lib/tags) 
A path of files to be used as tag files for the tag 
command. A requested tag is searched for in the 
specified files, sequentially. By default, files called 
tags are searched for in the current directory and in 
/usr/lib (a master file for the entire system). 

term (from environment $TERM) 
The terminal type of the output device. 

terse (default: noterse) 
Shorter error diagnostics are produced for the 
experienced user 

ttytype= 
Terminal type defined to system for visual mode. 
Can be defined before entering visual editor by 
TERM=type. 

warn (default: warn) 
Warns if there has been “[No write since last. 
change]” before a! command escape. 

window (default: window=speed dependent) 
The number of lines in a text. window in the visual 
command. The default is 8 at slow speeds (600 baud 
or less), 16 at medium speed (1200 baud), and the 
full screen (minus one line) at higher speeds. 


does 


w300, w1200, ~w9600 : 
These are not true options but set window only if 
the speed is slow (300), medium (1200), or high 
(9600), respectively. They are suitable for an EXINIT 
and make it easy to change the 8/16/full screen rule. 
wrapscean, ws (default: ws) 
Searches that use regular expressions in addressing 
will wrap around past the end of the file. 
wrapmargin, wm (default: wm—0) 
Defines a margin for automatic wrapover of text 
during input in open and visual modes. 
writeany, wa (default: nowa) 
Inhibit checks normally made before write 
commands, allowing a write to any file which the 
system protection mechanism will allow. 
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